home *** CD-ROM | disk | FTP | other *** search
/ Atari Mega Archive 1 / Atari Mega Archive - Volume 1.iso / graphics / pbm / pbm_man.zoo / man1 / pgmnorm.1 < prev    next >
Text File  |  1994-08-27  |  2KB  |  67 lines
  1.  
  2.  
  3.  
  4. pgmnorm(1)               USER COMMANDS                 pgmnorm(1)
  5.  
  6.  
  7.  
  8. NAME
  9.      pgmnorm - normalize the contrast in a portable graymap
  10.  
  11. SYNOPSIS
  12.      pgmnorm [-bpercent _✓N | -bvalue _✓N] [-wpercent _✓N | -wvalue  _✓N]
  13.      [_✓p_✓g_✓m_✓f_✓i_✓l_✓e]
  14.  
  15. DESCRIPTION
  16.      Reads a portable graymap as input.  Normalizes the  contrast
  17.      by  forcing the lightest pixels to white, the darkest pixels
  18.      to black, and linearly rescaling the ones  in  between;  and
  19.      produces a portable graymap as output.
  20.  
  21. OPTIONS
  22.      By default, the darkest 2 percent of all pixels  are  mapped
  23.      to  black,  and  the lightest 1 percent are mapped to white.
  24.      You can override these percentages by  using  the  -bpercent
  25.      and  -wpercent  flags,  or  you  can specify the exact pixel
  26.      values to be mapped by using the -bvalue and -wvalue  flags.
  27.      Appropriate  numbers  for  the  flags can be gotten from the
  28.      _✓p_✓g_✓m_✓h_✓i_✓s_✓t tool.  If you just want  to  enhance  the  contrast,
  29.      then choose values at elbows in the histogram; e.g. if value
  30.      29 represents 3% of the image but value 30  represents  20%,
  31.      choose  30  for  _✓b_✓v_✓a_✓l_✓u_✓e.   If you want to lighten the image,
  32.      then set _✓b_✓v_✓a_✓l_✓u_✓e to 0 and just fiddle with _✓w_✓v_✓a_✓l_✓u_✓e; similarly,
  33.      to  darken  the  image,  set  _✓w_✓v_✓a_✓l_✓u_✓e to maxval and play with
  34.      _✓b_✓v_✓a_✓l_✓u_✓e.
  35.  
  36.      All flags can be abbreviated to their shortest  unique  pre-
  37.      fix.
  38.  
  39. SEE ALSO
  40.      pgmhist(1), pgm(5)
  41.  
  42. AUTHOR
  43.      Partially based on the fbnorm filter  in  Michael  Mauldin's
  44.      "Fuzzy Pixmap" package.
  45.  
  46.      Copyright (C) 1989 by Jef Poskanzer.
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63. Sun Release 4.0   Last change: 28 February 1989                 1
  64.  
  65.  
  66.  
  67.